home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
maximus
/
cldrp330.zip
/
MAKEMSG.DOC
< prev
next >
Wrap
Text File
|
1992-02-12
|
10KB
|
288 lines
M A K E M S G 2.1
Tower Enterprises -- Jeff Galbraith
Copyright 1990-92
LICENCE
Copyright 1990-92 by Tower Enterprises -- Jeff Galbraith. All Rights Reserved.
You may copy and distribute copies of MAKEMSG in any medium, provided
that you display in a conspicuous area and appropriately publish on each
copy a valid copyright notice "Copyright 1990-92, (c) Tower Enterprises
-- Jeff Galbraith". Unmodified copies of this documentation must be
provided with the program - this is absolute. You may charge a
distribution fee for the physical act of transferring a copy, but no
more than is necessary to recover your costs incurred in the transfer.
WARRANTY
There is none. This software is provided "as is" without warranty of any
kind, either expressed or implied, including, but not limited to, the
implied warranties of merchantability and fitness for a particular
purpose. The entire risk as to quality and performance of MAKEMSG and
the accuracy of its associated documentation, is with you.
In no way will Tower Enterprises or Jeff Galbraith be held responsible
for the use or misuse of MAKEMSG, including, but not limited to,
defects, damages, lost monies, lost data, or other special, incidental
or consequential damages arising out of the use or inability to use
MAKEMSG.
You can contact the author at any of the addresses listed below:
FidoNet: 1:134/21.0
BBS: (403) 254-0278, 14.4K HST DS, v.32, v.42bis
Surface mail:
499 Midridge Dr. S.E.
Calgary, Alberta
Canada T2X 1B2
Please feel free to contact the author at any time to share your
comments about this software or any other software released by Tower
Enterprises -- Jeff Galbraith.
WHAT IS MAKEMSG?
MAKEMSG is a program that can take any document and create a message
suitable for echomail. MAKEMSG supports *.MSG format and Scott Dudley's
"SQUISH" format. MAKEMSG is used by many echo moderators for automatic
placing of rules in an echo area. as well, it can be used for placing
informational reports, like those generated by nodelist formatters, or
echomail billing programs.
THE OLD MAKEMSG
The older versions of MAKEMSG supported a header format in the contents
file. This contained the TO:, FROM:, and SUBJECT: lines. This is no
longer supported. This information is now gathered from the
configuration file, or from the command line.
THE CONFIGURATION FILE
The semi-colon acts as beginning of comment and can be used on any line.
Anything after a semi-colon is not parsed. You can use the -X command on
the command line to specify a different configuration file each time
MAKEMSG is run. Depending on how you want to do it, you can have command
line arguments override the configuration file by making sure the
configuration file is specified before any arguments. The the
configuration file is parsed first and then the arguments. Arguments
that come later, always override previous ones. Here is a list of key
words:
SYSTEM 1:134/21.0
MAKEMSG supports full 4D addresses. Include as much information as
possible about a system. Please do not use @DOMAIN, it will be ignored.
this is where the message originates.
FROM Jeff Galbraith
TO All
SUBJECT Test message
This is the header information. If it is not in a configuration file,
you must make sure to include it on the command line. MAKEMSG does some
minor checking on all pertinent fields. If certain ones do not have
information, default information will be used. On some, if there is no
information, the process will abort.
DIR c:\echo\test_sqi
This is the directory where *.MSG files are kept or the name of the
SQUISH message base, excluding extension (the same rules as used by the
SQUISHmail Conference Processor).
ORIGIN C::IDC/PDN/CLN*HST DS*(403)254-0278,Calgary,Ab
This is the origin line to use for all messages. If one is not used, you
will get a "* Origin: Unknown".
KILL
PRIVATE
CRASH
These are the only three verbs used for tagging messages at this time.
MSGTYPE SQUISH
;MSGTYPE *.MSG
This is the type of message base that DIR points to. Use only one, not
both, at a time.
CONTENTS c:\bbs\test.doc
This is the name of the document to be used for the body of the message.
If it is not in the current directory, make sure you put in the full
path as well.
RECEIVE 1:134/40.0
This is the node that is to receive the message, IF the message is to be
netmail. If it is not netmail, then ignore this command.
EDITOR qedit.exe
MAX c:\bbs\area.dat
NOTE: These are not yet implemented in this version yet. In a future
version of MAKEMSG, an interactive part will be added. This will allow
you to create messages on the fly, thus the need to know which editor to
use. The second command will be for Maximus users. You will get a
picklist of available echoes of where the message will be sent.
THE COMMAND LINE
Syntax:
MAKEMSG <args>
Args: ! = Crash message flag
$ = Squish base (default=*.MSG)
C<path> = Contents file
D<path> = Directory (default=current)
F"string" = From (default=MAKEMSG v2.00)
H = Help
K = Kill message flag
J"string" = subJect
O"string" = Origin line (default=Unknown)
P = Private message flag
R<address> = Receiving node (zone:net/node.point)
S<address> = Sending node (zone:net/node.point)
T"string" = TO (default=All)
X<path> = configuration file
Retain quotes (") on arguments that have them.
EXAMPLE:
MAKEMSG -$ -F"Jeff Galbraith" -S1:134/21.0 -Cc:\test.doc -Dc:\echo\public
Typing MAKEMSG by itself will bring up some help (as above). All
commands must have a dash (-) or slash (/) in front of them.
-!
Make this message CRASH.
-$
This message is going into a SQUISH format (default=*.MSG).
-C<contents_file>
-Cc:\bbs\test.doc
This is the file to use for the body of the message. If it is not in the
current directory, make sure you put in the full path as well.
-D<directory>
-Dc:\echo\test_sqi
This is the directory where *.MSG files are kept or the name of the
SQUISH message base, excluding extension (the same rules as used by the
SQUISHmail Conference Processor).
-F"from name"
-F"Jeff Galbraith"
This is who the message is from. Make sure the name is enclosed in
quotation marks.
-H
This will bring up the same help as if you had typed MAKEMSG by itself.
-K
Kill this message after it is sent.
-J"subject line"
-J"Test Message"
This is the subject line of the message. Make sure the name is enclosed
in quotation marks.
-O"origin line"
-O"C::IDC/PDN/CLN*HST DS*(403)254-0278,Calgary,Ab"
This is the line to be used for the Origin line. make sure it is
enclosed in quotation marks. The length should not exceed 55 characters,
but if it does, MAKEMSG will truncate it properly.
-P
Make this message Private.
-R<receiving_node>
-R1:134/40.0
This is the node that is to receive the message, IF the message is to be
netmail. If it is not netmail, then ignore this command.
-S<sending_node>
-S1:134/21.0
MAKEMSG supports full 4D addresses. Include as much information as
possible about a system. Please do not use @DOMAIN, it will be ignored.
this is where the message originates.
-T"to name"
-T"All"
This is who the message is addressed to. make sure the name is enclosed
in quotation marks.
-X<configuration_file>
-Xc:\bbs\makemsg1.cfg
This is an alternate configuration file that MAKEMSG should use instead
of the default one.
HISTORY
2.1 - bug fix release. MakeMsg was not recognizing nodes with a node
number of 0. Fixed. Thanks to Bob Donaldson of 1:114/17.
2.01 - bug fix release
2.00 - Squish format added using scott Dudley's MSGAPI v.0
1.00 - 1.07, support of Fido *.MSG, various fixes
CREDITS and TRADEMARKS
MAKEMSG contains, since release 2.00, some code from Scott Dudley.
MSGAPI Copyright Scott Dudley.
SQUISH is a trademark of Scott Dudley.
Special thanks, as always, to Henning Johansen (1:134/40.0@fidonet.org)
for the best ideas and suggestions. Also, many thanks to Kevin Klement
(134/77), Kathi Crockett (134/8) and Neil Witwicki (134/64) for the
thorough beta testing.